home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _comms / comms / _dialit / !DialIt / !Help < prev    next >
Text File  |  1990-09-29  |  9KB  |  278 lines
  1. !DialIt, A Mercury-Capable Telephone Dialler
  2. ============================================
  3.  
  4. Current version: !DialIt version 1.04, 29-Sep-90.
  5.  
  6. Copyright (C) Ian A. Young, 1990
  7.  
  8. In conjunction with an autodial modem attached to
  9. the serial port, this application allows you to:
  10.  
  11.    * dial telephone numbers for an attached
  12.      voice telephone
  13.  
  14.    * dial numbers for a comms program which isn't
  15.      clever enough to do it itself, or which breaks
  16.      when you give it very long ones
  17.  
  18.    * route calls via your Mercury account, if you
  19.      have one.
  20.  
  21.  
  22. Modem Configuration
  23. ===================
  24.  
  25. A modem is assumed to be attached to the serial
  26. port.  !DialIt doesn't try and set baud rate or
  27. framing parameters, so that it can be used with
  28. your favourite communications program.  Therefore,
  29. if you want to use it without such a communications
  30. program, you should configure the BAUD and DATA
  31. parameters to some setting your modem will know.
  32. For example, I have:
  33.  
  34.    *Configure Baud 5          (2400 baud)
  35.    *Configure Data 4          (8/N/2)
  36.  
  37. To dial, !DialIt precedes the number to be dialled
  38. with a string it finds in its !Config file; see this
  39. for more details.  To hang up, !DialIt goes through
  40. the following sequence:
  41.  
  42.    1) Drop DTR
  43.    2) Wait 0.25 seconds
  44.    3) Raise DTR again
  45.    4) Wait 0.25 seconds
  46.    5) Send the string "ATH<return>" to the modem
  47.  
  48. This assumes that the modem knows that it should
  49. return to command level at the very least when DTR
  50. is toggled.  Some modems hang up, too, when this
  51. is done; that's even better.  Please let me know if
  52. !DialIt can't cope with hanging up your modem.
  53.  
  54.  
  55. Dialling Numbers
  56. ================
  57.  
  58. !DialIt fetches its telephone directory from the
  59. !Config file inside its application directory.  The
  60. supplied file gives some examples of both M and P-
  61. type numbers.  'M' implies a Modem will answer;
  62. 'P' a Person.  In the latter case, !DialIt puts a
  63. semi-colon on the end of the dial string it sends to
  64. the modem so that the modem won't try and connect
  65. to a modem at the other end.  !DialIt can also get
  66. one-off numbers to dial (along with modem/person
  67. information) from a window.
  68.  
  69. If !DialIt is asked to dial a modem (through any
  70. of the several methods described here) then it will
  71. do so without further ado.  If the call fails, the
  72. modem will automatically time out on your behalf and
  73. hang up the line.
  74.  
  75. The situation with People (non-modems) is slightly
  76. more complicated because TWO "telephones" might be
  77. active ("off-hook") at your end: the modem and the
  78. real telephone.  BOTH of these must hang up in order
  79. for the BT exchange to know that the line is idle.
  80. However, the modem will not do this for you, because
  81. it cannot tell when to do it: there is no handy clue
  82. like the absence of a carrier to tell it.  !DialIt's
  83. solution to this is to require the USER to tell it
  84. when the modem should be hung up, whenever it is
  85. dialling a person rather than a modem.  It does this
  86. by forcing the DialIt main window to pop up in these
  87. cases so that F3 (or the "Done" button in the
  88. window) is available for this operation.
  89.  
  90. Simple use of !DialIt therefore proceeds as follows:
  91.  
  92.    a) Dialling a bulletin board
  93.  
  94.       1) click "menu" over the !DialIt icon
  95.       2) move into the "Dial" submenu
  96.       3) select the number you want
  97.  
  98.    b) Dialling a person
  99.  
  100.       1) click "menu" over the !DialIt icon
  101.       2) move into the "Dial" submenu
  102.       3) select the number you want
  103.       4) The DialIt window appears
  104.       5) You hear the other phone ringing,
  105.          and pick up your own phone (in either
  106.          order)
  107.       6) You press F3 to hang up the modem and
  108.          remove the DialIt window from the screen
  109.       7) The phone answers and you begin to speak
  110.  
  111. Following sections describe the DialIt window and
  112. the DialIt menu in more detail.
  113.  
  114.  
  115. DialIt Window
  116. =============
  117.  
  118. If you click over the !DialIt icon on the icon bar,
  119. or when you ask it to dial a non-modem number from
  120. the menu, a window will open with the following
  121. items:
  122.  
  123.    * "Dial": click on this (or press F1, or Return)
  124.      to dial the number being displayed below.
  125.  
  126.    * "Hang Up": click on this (or press F2) to hang
  127.      up the phone.
  128.  
  129.    * "Done": click on this (or press F3) to hang up
  130.      the phone AND close the window.  This is very
  131.      useful for telling !DialIt that it should now
  132.      release the phone line and vacate the screen.
  133.  
  134.    * "Modem Answers" should be set if a modem will
  135.      answer the call, and not set for a person.
  136.  
  137.    * "Number to Dial" is a writeable icon which will
  138.      accept a telephone number to dial.  If you
  139.      press Return while in this icon, the number
  140.      will be dialled.
  141.  
  142.  
  143. DialIt Menu
  144. ===========
  145.  
  146. Clicking the menu button over the !DialIt icon gives
  147. a menu with the following items:
  148.  
  149.    * "Info" gives some information about !DialIt
  150.  
  151.    * "Hang Up" hangs up the phone (same as the
  152.      namesake button in the DialIt window)
  153.  
  154.    * "Redial" dials the last number again (same as
  155.      the "Dial" button in the DialIt window)
  156.  
  157.    * "Dial" leads to a submenu made up of the
  158.      numbers in !DialIt's telephone directory;
  159.      selecting one of these causes that number
  160.      to be dialled.  If the number represents
  161.      a normal phone rather than a modem, the main
  162.      DialIt window will open automatically, so that
  163.      once the phone is answered you can tell DialIt
  164.      to go away by pressing F3 (or selecting the
  165.      "Done" button.
  166.  
  167.    * "Quit" causes !DialIt to terminate.
  168.  
  169.  
  170. Mercury Access
  171. ==============
  172.  
  173. If you have a Mercury account, !DialIt can be told
  174. about it so that it can route calls it dials over
  175. the Mercury network rather than British Telecom's.
  176. This saves you money on long-distance and internat-
  177. ional calls.  You don't need a Mercury-compatable
  178. "blue button" telephone to take advantage of this
  179. service if you use !DialIt.  All you need to do to
  180. get a Mercury account is dial 0800 424 194 and ask
  181. for their Mercury 2300 service information pack.
  182. The standing charge is 7.50 per year, plus VAT.
  183. You WILL need a modem which can dial tones for you,
  184. not just pulses, though.
  185.  
  186. If you have set up the !Config file as described in
  187. the comments therein, all phone numbers starting
  188. with a '0' will be routed via Mercury.  There are
  189. some cases where this is the wrong thing to do, and
  190. !DialIt will get the wrong answer:
  191.  
  192.    * Local calls which nevertheless have an STD code
  193.      on the beginning; !DialIt doesn't have a method
  194.      by which you can tell it about these, at the
  195.      moment.
  196.  
  197.    * Probably BT chatlines, cellphones and so on.
  198.      I don't do any of this, so I don't know as yet.
  199.  
  200. For such calls, use the phone's own buttons, but let
  201. me know so that I can think about making !DialIt
  202. smarter.  Note that I HAVE told !DialIt about 0800
  203. numbers so that it can dial the Mercury customer
  204. assistance freephone, for example, which I have
  205. included in the example !Config file.
  206.  
  207.  
  208. Disclaimer
  209. ==========
  210.  
  211. I have nothing to do with Mercury, except that I am
  212. one of their customers.
  213.  
  214.  
  215. Terms of Use
  216. ============
  217.  
  218. You're welcome to make any personal use of this
  219. application you like: as long as you don't make
  220. money by it, I don't expect any from you.  Uploading
  221. to BBSes and putting on PD disks counts as personal
  222. use in this context, putting the code into your new
  223. amazing ú100 comms package doesn't.  Not that you
  224. would want to.  I'd appreciate any additional info
  225. anyone might have in this area, and any suggestions
  226. for improvement.  I should warn, though, that it is
  227. now a pretty stable application and I'm bound to be
  228. a bit afraid of disturbing it...
  229.  
  230. There is no warranty, express or implied, associated
  231. with your use of this application.  In particular,
  232. if you are worried about whether !DialIt might one
  233. day wrongly route some telephone call via BT when it
  234. should have used Mercury (or vice versa) then you
  235. will have to buy a blue-button phone and a Mercury-
  236. compatable modem instead of using !DialIt; please
  237. don't attempt to send me your phone bill... :-)
  238.  
  239.  
  240. Revision History
  241. ================
  242.  
  243. V1.04 29-Sep-90 Permit spaces in the writeable icon
  244.                 in the main DialIt window.
  245.  
  246. V1.03 25-Sep-90 Teach it about 0800 numbers
  247.                 Make main window be brought up when
  248.                 a human is dialled, and have it
  249.                 select itself as well, whenever it
  250.                 is referenced in this way, so that
  251.                 F3 will work.
  252.  
  253. V1.02 ??-Sep-90 Read directory and other config
  254.                 information from !Config file.
  255.  
  256. V1.01 ??-Sep-90 Teach it about my Mercury account.
  257.                 Again, all information hard-wired.
  258.  
  259. V1.00 ??-Sep-90 Original version with hard-wired
  260.                 dialling directory.
  261.  
  262.  
  263. Contacts
  264. ========
  265.  
  266. You can find me at:
  267.  
  268. SnailMail:     Ian A. Young
  269.                91 Causewayside
  270.                Edinburgh
  271.                EH9 1QG
  272.  
  273. Email:         iay@threel.co.uk
  274.               (iay@uk.co.threel if you're on JANET)
  275. Cix:           iyoung            (not often)
  276. Arcade BBS:    #458  (Ian Young) (often)
  277. Archive BBS:   #1060 (Ian Young) (not often)
  278.